home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / pc_board / pcbudc10.zip / PCBUPDC.DOC < prev    next >
Text File  |  1992-11-09  |  10KB  |  254 lines
  1.                     PCBoard UPload Date Checker - PCBUPDC v1.0      Page 1
  2.  
  3. DISCLAIMER   . . . . . . . . . . . . . . . . . . . . . . . . .  1
  4. LICENSE  . . . . . . . . . . . . . . . . . . . . . . . . . . .  1
  5. INTRODUCTION . . . . . . . . . . . . . . . . . . . . . . . . .  2
  6. FILES INCLUDED . . . . . . . . . . . . . . . . . . . . . . . .  2
  7.     PCBUPDC.EXE  . . . . . . . . . . . . . . . . . . . . . . .  2
  8.     PCBUPDC.TXT  . . . . . . . . . . . . . . . . . . . . . . .  2
  9.     PCBTEST.BAT  . . . . . . . . . . . . . . . . . . . . . . .  2
  10.     PCBUPDC.CFG  . . . . . . . . . . . . . . . . . . . . . . .  2
  11. PCBUPDC.EXE Parameters . . . . . . . . . . . . . . . . . . . .  2
  12. INSTALLATION . . . . . . . . . . . . . . . . . . . . . . . . .  3
  13.     PCBUPDC.CFG  . . . . . . . . . . . . . . . . . . . . . . .  3
  14.     PCBTEST.BAT  . . . . . . . . . . . . . . . . . . . . . . .  4
  15. REGISTER FORM  . . . . . . . . . . . . . . . . . . . . . . . .  5
  16.  
  17.  
  18. DISCLAIMER
  19.  
  20.     This software is provided without any guarantee, either expressed or
  21.     implied.  All responsibilities for its use rest with the user of the
  22.     software and not the author.
  23.  
  24.     PCBUPDC software and this document are (C) Copyright 1992
  25.     by Cam DeBuck.  All rights reserved World Wide.
  26.  
  27.  
  28. LICENSE
  29.  
  30.     PCBUPDC is not in the Public Domain.  PCBUPDC is not free.
  31.     Non-registered users are granted a limited, 30-day license to determine
  32.     whether or not the program meets their needs.  Continued use of PCBUPDC
  33.     beyond the 30-day evaluation time period requires registration of the
  34.     program.  Use of non-registered copies of PCBUPDC beyond the original
  35.     evaluation period is strictly prohibited.  No one may modify PCBUPDC for
  36.     any reason, in any way, including but not limited to decompiling-
  37.     compiling, patching, disassembling, or reverse engineering the program.
  38.     PCBUPDC may be copied and distributed to others, subject to the above
  39.     restrictions and the following:
  40.  
  41.       * PCBUPDC must be copied in unmodified form, including the file
  42.         containing this license information.
  43.       * Complete PCBUPDC documentation must be included.
  44.       * No copying fee of any type may be assessed other than basic
  45.         charges for the cost of the copying medium.
  46.       * PCBUPDC may not be distributed with any other software or
  47.         hardware product(s) without the express written permission of
  48.         Cam DeBuck.
  49.  
  50.     SysOps (bulletin board System Operators) may make PCBUPDC available for
  51.     downloading by their users as long as all above conditions are met.
  52.  
  53.     Commercial Distributors of Public Domain, ShareWare, or User Supported
  54.     software may distribute PCBUPDC subject to the above conditions only
  55.     after obtaining specific written permission from Cam DeBuck and filling
  56.     out a registration form for upgrade notifications.  This condition
  57.     supersedes any and all previous agreements.
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.                     PCBoard UPload Date Checker - PCBUPDC v1.0      Page 2
  67.  
  68. INTRODUCTION
  69.  
  70.         Thank you for trying PCBUPDC, the PCBoard BBS Upload Date Checker.
  71.     You'll find this to be a very handy program for checking the contents
  72.     of .ZIP files for valid dates. It is designed as an add-on to CAMS-CRC
  73.     but will work with any upload checker, simply run it after any upload
  74.     checker in PCBTEST.BAT
  75.  
  76.         During the processing of .ZIP files, it extracts the information of
  77.     all .COM .EXE and .O* files contained within the .ZIP and then compares
  78.     the date of each of these files with the oldest file date that you have
  79.     set within the configuration file.
  80.  
  81.         A file called PCBUPDC.LOG is always created and is displayed to the
  82.     caller after the file has been checked if you have OUTCOMM.EXE or any
  83.     other program that will display text files out the com port. This file
  84.     will tell the user which files inside the compressed file were tested
  85.     and whether each file passed or failed the date check.
  86.  
  87.         Utilizes the Registration Key System for Programmers Version 2.10.
  88.  
  89. FILES INCLUDED
  90.   
  91.     You should have the following files on your DISK or .ZIP file:
  92.  
  93.       PCBUPDC.EXE   - This is executable program.
  94.       PCBUPDC.TXT   - Text file explaining that the file is being checked
  95.                       for current dates, may contain PCB@ color codes.
  96.                       Edit with your BBS name.
  97.       PCBTEST.BAT   - A sample PCBTEST.BAT
  98.       PCBUPDC.CFG   - This is a configuration file that needs to be
  99.                       placed in the NODE directory or location may be
  100.                       specified on the command line.
  101.  
  102.  
  103. PCBUPDC.EXE Parameters
  104.  
  105.      PCBUPDC.EXE has two parameters passed to it.
  106.  
  107.      These parameters must be on the command line in the proper order.
  108.      The first parameter is mandatory, the second parameter is optional.
  109.  
  110.     PCBUPDC.EXE Path\Filename.Ext Path\PCBUPDC.CFG
  111.  
  112.  Path\Filename.Ext - This is the path and full filename of the file to
  113.                      be checked, this is passed by PCBoard as the %1
  114.                      parameter found in the batch file.
  115.  
  116.  Path\PCBUPDC.CFG  - Specifies where you have placed the configuration
  117.                      file. The default is the current directory, single
  118.                      user BBS. The config file may be any name of your
  119.                      choosing.
  120.  
  121.  
  122.  
  123.                     PCBoard UPload Date Checker - PCBUPDC v1.0      Page 3
  124.  
  125. INSTALLATION
  126.   
  127.       First place PCBUPDC.EXE in your DOS path.  I suggest C:\PCB. Place
  128.   PCBUPDC.TXT into your CAMS-CRC directory (D:\CAMS-CRC) or any other
  129.   drive\directory of your choice as its location is passed on the
  130.   command line to OUTCOMM.EXE.
  131.  
  132. PCBUPDC.CFG File
  133.  
  134.       You will need to make sure you create a PCBUPDC.CFG, location is not
  135.   important but may be placed in the PCBoard home directory (C:\PCB),
  136.   D:\CAMS-CRC or elsewhere as its location may be passed on the command
  137.   line.
  138.  
  139.   The PCBUPDC.CFG contains 4 lines (lines 3 and 4 are optional).
  140.   The order is important, and the first item is case sensitive for
  141.   registered versions.
  142.  
  143. Registered Name
  144. 0
  145. 891231
  146. 50
  147.  
  148. Line 1: The name your copy of PCBUPDC is registered to - case sensitive!
  149. Line 2: Registration key
  150. Line 3: Date of Oldest executable allowed YYMMDD - Year Month Day
  151.         Defaults to 810101 if blank (01/01/81 not 01/01/80)
  152. Line 4: Minimum Percentage of Old Dates defaults to 100% if blank
  153.  
  154.                     PCBoard UPload Date Checker - PCBUPDC v1.0      Page 4
  155.  
  156. INSTALLING PCBTEST.BAT
  157.  
  158.       Installing the PCBTEST.BAT file is fairly simple.  I suggest that
  159.   you use the example PCBTEST.BAT and to modify your existing
  160.   PCBTEST.BAT to fit your needs.
  161.  
  162.       When a file is uploaded (This can be done locally or remotely), the
  163.   PCBUPDC.LOG file is created if the file being checked is a .ZIP.
  164.   It's suggested that you delete this file after it has been processed.
  165.   I suggest that you copy+ it to another file and trim it when you feel it's
  166.   necessary.  You'll find that the example PCBTEST.BAT file does this.
  167.  
  168. Sample PCBTEST.BAT snippet:
  169.  
  170. REM     Other checker etc. above this line.
  171.  
  172. REM     Check to see if file is already flagged as bad, if so skip
  173. IF EXIST PCBFAIL.TXT GOTO SKIPUPDC
  174.  
  175. REM     Display PCBUPDC.TXT to the caller.
  176. OUTCOMM.EXE %PCBDRIVE%%PCBDIR% D:\CAMS-CRC\PCBUPDC.TXT
  177.  
  178. REM     Now let's check the exec file dates in the upload!
  179. PCBUPDC %1 C:\PCB\PCBUPDC.CFG
  180.  
  181. REM     Check for log, display to caller if found.  If it does not exist
  182. REM     then either bad .ZIP or upload was NOT a .ZIP file.
  183. IF EXIST PCBUPDC.LOG GOTO DISPLOG
  184. GOTO SKIPUPDC
  185.  
  186. REM     Display the PCBUPDC.LOG file so the user can see results
  187. :DISPLOG
  188. OUTCOMM.EXE %PCBDRIVE%%PCBDIR% PCBUPDC.LOG
  189.  
  190. REM     Now Copy+ the PCBUPDC.LOG to a permanent file
  191. REM     This keeps a complete log of activity
  192. COPY C:\PCB\PUPDC%PCBNODE%+PCBUPDC.LOG C:\PCB\PUPDC%PCBNODE%.LOG
  193.  
  194. REM     This line and the following 2 lines may be deleted if you wish
  195. REM     since the file is overwritten if it exists on the next upload
  196. DEL PCBUPDC.LOG
  197.  
  198. :SKIPPCBUP
  199. echo The End!
  200.  
  201.                     PCBoard UPload Date Checker - PCBUPDC v1.0      Page 5
  202.  
  203.  
  204.                         PCBUPDC v1.0  REGISTRATION FORM
  205.                         ------------------------------
  206.  
  207. (Please type or print)                          Date: _____________________
  208.  
  209. First name: _________________________  Last: ______________________________
  210.  
  211.    Address: _____________________________________________
  212.  
  213.             _____________________________________________
  214.  
  215.       City: ________________________      State/province: _________________
  216.  
  217.    Country: ________________________     ZIP/postal code: _________________
  218.  
  219. Where did you find PCBUPDC? ________________________________________________
  220.  
  221. Registration Name:_________________________________________________________
  222.                                (Case SENSITIVE!)
  223.  
  224.                                           TOTAL amount enclosed $___.______
  225.  
  226.  
  227. *****************************************
  228. * Payment must be check or money order. *
  229. *****************************************
  230.  
  231. Comments: _________________________________________________________________
  232.           
  233.           _________________________________________________________________
  234.  
  235.  
  236. Write check or money order out for $7.50 to Cam DeBuck and send to:
  237.  
  238.                           Cam DeBuck
  239.                           230 Medford Drive
  240.                           Fayetteville, GA  30214-1948
  241.  
  242. Please Allow 15 work days for your registered CRC to arrive in the mail.
  243. Thanks.
  244.  
  245.   All orders are rushed!
  246.  
  247.  
  248. If you have any problems, please contact me at:
  249.  
  250.       BBS (404)461-5449 USR DST 16800
  251.       BBS (404)461-5947 ATI V32  9600
  252.       Leave a message to me on the Mustang Software BBS
  253.  
  254.